home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / ast_text / faqs / complang.c!! / g!! < prev    next >
Text File  |  1993-06-28  |  30KB  |  742 lines

  1. Path: senator-bedfellow.mit.edu!enterpoop.mit.edu!spool.mu.edu!howland.reston.ans.net!agate!usenet
  2. From: jbuck@ohm.berkeley.edu (Joe Buck)
  3. Newsgroups: gnu.g++.help,comp.lang.c++,news.answers,comp.answers
  4. Subject: FAQ for g++ and libg++, plain text version [Revised 31 May 1993]
  5. Supersedes: <g++FAQ_05_15_1993_texi@ohm.berkeley.edu>
  6. Followup-To: poster
  7. Date: 1 Jun 1993 13:00:09 GMT
  8. Organization: University of California, Berkeley
  9. Lines: 726
  10. Approved: news-answers-request@MIT.edu
  11. Expires: 1 Jul 1993 00:00:00 GMT
  12. Message-ID: <g++FAQ_06_01_1993_texi@ohm.berkeley.edu>
  13. NNTP-Posting-Host: ohm.eecs.berkeley.edu
  14. Xref: senator-bedfellow.mit.edu gnu.g++.help:3533 comp.lang.c++:44200 news.answers:8950 comp.answers:844
  15.  
  16. Archive-name: g++-FAQ/plain
  17. Last-modified: 31 May 1993
  18. Frequency: bimonthly
  19.  
  20. [ this is the plain text version, the parent is the texinfo version ]
  21.  
  22.  
  23. Preface
  24. *********
  25.  
  26.    This is a list of frequently asked questions (FAQ) for g++ users;
  27. thanks to all those who sent suggestions for improvements.  Thanks to
  28. Marcus Speh for doing the index.
  29.  
  30.    Many FAQ's, including this one, are available on the archive site
  31. rtfm.mit.edu, in the directory pub/usenet/news.answers.  This FAQ may
  32. be found in the subdirectory g++-FAQ.
  33.  
  34.    There have been many, many changes since the last version of this
  35. list, prompted by a major release of gcc.  I've fixed this document as
  36. best I could, but I'm sure it will need some more work.  Please send
  37. fixes, and please be kind.
  38.  
  39.    I'm looking for new questions (*with* answers), better answers, or
  40. both.  One thing that's missing is a section on templates and template
  41. problems with g++; I'm looking for contributions on this score.  You
  42. can mail comments, suggestions, flames, etc. to
  43. jbuck@ohm.berkeley.edu.  Please don't assume, though, that because my
  44. name is on this thing that I am the world expert on g++/C++ and you
  45. should mail all your tricky questions to me.  I'd like to be helpful
  46. but I'm getting more of this than I can deal with lately.
  47.  
  48.    This FAQ is intended to supplement, not replace, Marshall Cline's
  49. excellent FAQ for comp.lang.c++.  Especially if g++ is the first C++
  50. compiler you've ever used, the question "How do I do <X> with g++?" is
  51. probably really "How do I do <X> in C++?".  You can obtain the C++ FAQ
  52. by anonymous FTP from sun.soe.clarkson.edu [128.153.12.3], in the file
  53. ~ftp/pub/C++/FAQ.  (There is also a mail server for that FAQ, but it
  54. seems to be broken).
  55.  
  56.  
  57. Obtaining Source Code
  58. *********************
  59.  
  60.  
  61. How do I get a copy of g++ for Unix?
  62. ====================================
  63.  
  64.    First, you may already have it if you have gcc for your platform;
  65. g++ and gcc are combined now (as of gcc version 2.0).
  66.  
  67.    You can get g++ from a friend who has a copy, by anonymous FTP or
  68. UUCP, or by ordering a tape or CD-ROM from the Free Software
  69. Foundation.
  70.  
  71.    The Free Software Foundation is a nonprofit organization that
  72. distributes software and manuals to raise funds for more GNU
  73. development.  Getting your copy from the FSF contributes directly to
  74. paying staff to develop GNU software.  CD-ROMs cost $100 if an
  75. individual is buying, or $400 if an organization is buying.  Tapes
  76. cost around $200 depending on media type.  I recommend asking for
  77. version 2, not version 1, of g++.
  78.  
  79.    For more information about ordering from the FSF, contact
  80. gnu@prep.ai.mit.edu or phone (617) 876-3296.
  81.  
  82.    Here is a list of anonymous FTP archive sites for GNU software.
  83.  
  84.      Japan: ftp.cs.titech.ac.jp, utsun.s.u-tokyo.ac.jp:ftpsync/prep
  85.      Australia: archie.au:gnu
  86.      Europe: src.doc.ic.ac.uk:gnu, ftp.informatik.tu-muenchen.de,
  87.          ftp.informatik.rwth-aachen.de:pub/gnu,
  88.          nic.funet.fi:pub/gnu, ugle.unit.no, isy.liu.se,
  89.          ftp.stacken.kth.se, sunic.sunet.se, ftp.win.tue.nl,
  90.          ftp.diku.dk, ftp.eunet.ch, archive.eu.net
  91.      United States: wuarchive.wustl.edu, ftp.cs.widener.edu,
  92.          uxc.cso.uiuc.edu, col.hp.com, gatekeeper.dec.com:pub/GNU,
  93.          ftp.uu.net:packages/gnu
  94.  
  95.    The "official site" is prep.ai.mit.edu, but your transfer will
  96. probably go faster if you use one of the above machines.
  97.  
  98.    If you use the HP Precision Architecture (HP-9000/7xx and
  99. HP-9000/8xx) and you want to use debugging, you'll need to grab a
  100. special version of GAS from the University of Utah, site
  101. jaguar.cs.utah.edu.  Look in the "/dist" directory for pa-gas-1.36.u5.
  102.  A non-standard debug format is used, since HP considers their debug
  103. format a trade secret.  The GNU debugger, GDB, understands the debug
  104. format produced by this version of GAS, but not the format produced by
  105. HP's compilers.
  106.  
  107.    Some bug fixes for the HP that weren't complete in time for the
  108. 2.4.0 release are available from the same site in version
  109. gcc-2.4.0.u1.  Both sources and precompiled binaries are available
  110. from this site.
  111.  
  112.    [ How does gcc-2.4.0.u1 compare to gcc-2.4.1? - jbuck ]
  113.  
  114.    libg++-2.3 requires some patches to install correctly on HP-PA
  115. systems.  You may obtain these patches by anonymous FTP from the site
  116. geod.emr.ca in /pub/hp/libg++-2.3.patches.tar.Z.  Other interesting
  117. notes for HP-PA folks on use of GNU software on this architecture may
  118. be found in the file "gnu-results-1.6" in the same directory (1.6 may
  119. be replaced with some later number).
  120.  
  121.    [ I don't know how the above changes with libg++ 2.3.1 - jbuck ]
  122.  
  123.    UUNET customers can get GNU sources from UUNET via UUCP.  UUCP-only
  124. sites can get GNU sources by "anonymous UUCP" from site "osu-cis" at
  125. Ohio State University.  You pay for the long-distance call to OSU; the
  126. price isn't too bad on weekends at 9600 bps.  Send mail to
  127. uucp@cis.ohio-state.edu or osu-cis!uucp for more information.
  128.  
  129.    OSU lines are often busy.  If you're in the USA, and are willing to
  130. spend more money, you can get sources via UUCP from UUNET using their
  131. 900 number: 1-900-GOT-SRCS (900 numbers don't work internationally). 
  132. You will be billed $0.50/minute by your phone company.
  133.  
  134.    Don't forget to retrieve libg++ as well!
  135.  
  136.  
  137. How do I get a copy of g++ for (some other platform)?
  138. =====================================================
  139.  
  140.    The standard gcc/g++ distribution includes VMS support.  Since the
  141. FSF people don't use VMS, it's likely to be somewhat less solid than
  142. the Unix version.  Precompiled copies of g++ and libg++ in
  143. VMS-installable form are available by FTP from mango.rsmas.miami.edu.
  144.  
  145.    DJ Delorie has ported gcc/g++ to MS-DOS; this port is popularly
  146. known as "DJGPP" (the P's stand for "plus").  It can be found on many
  147. FTP archive sites; its "home" is on omnigate.clarkson.edu, directory
  148. ~ftp/pub/msdos/djgpp.  Note: omnigate restricts the number of anonymous
  149. users.  Make sure you're retrieving the current version (1.09) which
  150. is a port of gcc-2.2.2 (2.3.1 through 2.4.1 have been released since
  151. then, but have not yet been ported to DOS).  It is also available on
  152. site wuarchive.wustl.edu, in directory mirrors/msdos/djgpp, and many
  153. other places as well.
  154.  
  155.    For information on Amiga ports of gcc/g++, retrieve the file
  156. /pub/gnu/MicrosPorts/Amiga from prep.ai.mit.edu, or write to Markus M.
  157. Wild <wild@nessie.cs.id.ethz.ch>, who I hope won't be too upset that I
  158. mentioned his name here.
  159.  
  160.    A port of gcc-2.3.1 to the Atari ST can be found on the site
  161. "atari.archive.umich.edu", under /atari/Gnustuff/Tos, along with many
  162. other GNU programs.  See the FAQ for the Usenet group
  163. "comp.sys.atari.st" for more information.
  164.  
  165.    There are two different ports of gcc-2.3.3 (and g++) to OS/2, the
  166. so-called EMX port, which requires a particular Unix emulator, and a
  167. port called "gcc/2", which runs native.  The latter port uses a rather
  168. buggy port of the BSD libc.  For more information ask around on
  169. "comp.os.os2.programmer".  gcc/2 can be obtained by FTP from
  170.  
  171.      ftp-os2.nmsu.edu (128.123.35.151) in /pub/os2/2.x/unix/gnu/gcc2-233
  172.      luga.latrobe.edu.au (131.172.2.2) in /pub/os2/2.x/unix/gnu/gcc2-233
  173.  
  174.    The current maintainer of the gcc/2 port is Colin Jensen (Michael
  175. Johnson did the original port).  His address is ljensen@netcom.com.
  176.  
  177.    Eberhard Mattes did the EMX port.  His address is
  178. mattes@azu.informatik.uni-stuttgart.de.
  179.  
  180.    Because the legal policies of Apple threaten the long-term goals of
  181. FSF, as well as the concept of free software, no support will be lent
  182. to efforts to port GNU software to Macintosh or other Apple hardware.
  183.  
  184.  
  185. But I can only find g++-1.42!
  186. =============================
  187.  
  188.    "I keep hearing people talking about g++ 2.4.1 (or some other number
  189. starting with 2), but the latest version I can find is g++ 1.42. 
  190. Where is it?"
  191.  
  192.    As of gcc 2.0, C, C++, and Objective-C as well are all combined
  193. into a single distribution called gcc.  If you get gcc you already
  194. have g++.  The standard installation procedure for any gcc version 2
  195. compiler will install the C++ compiler as well.
  196.  
  197.    One could argue that we shouldn't even refer to "g++-2.x.y" but
  198. it's a convention.  It means "the C++ compiler included with
  199. gcc-2.x.y".
  200.  
  201.  
  202. What is the latest version of gcc, g++, and libg++?
  203. ===================================================
  204.  
  205.    The latest "2.x" version of gcc/g++ is 2.4.1, released May 26, 1993. 
  206. The latest version of libg++ is 2.3.1, also released May 26, 1993.
  207.  
  208.    For some non-Unix platforms, 2.2.2 may be the latest compiler that
  209. has been ported.  libg++ 2.3 will not compile with gcc-2.2.2; use
  210. libg++ 2.2 instead.
  211.  
  212.    The latest "1.x" version of gcc is 1.42, and the latest "1.x"
  213. version of g++ is 1.42.0.  I recommend against using them except in
  214. special circumstances.
  215.  
  216.  
  217. Installation Issues and Problems
  218. ********************************
  219.  
  220.  
  221. I can't build g++ 1.x.y with gcc-2.x.y!
  222. =======================================
  223.  
  224.    "I obtained gcc-2.x.y and g++ 1.x.y and I'm trying to build it, but
  225. I'm having major problems.  What's going on?"
  226.  
  227.    If you wish to build g++-1.42, you must obtain gcc-1.42 first.  The
  228. installation instructions for g++ version 1 leave a lot to be desired,
  229. unfortunately, and I would recommend that, unless you have a special
  230. reason for needing the 1.x compiler, that C++ users use the latest
  231. g++-2.x version, as it is the version that is being actively
  232. maintained.
  233.  
  234.    There is no template support in g++-1.x, and it is generally much
  235. further away from the ANSI draft standard than g++-2.x is.
  236.  
  237.  
  238. OK, I've obtained gcc; what else do I need?
  239. ===========================================
  240.  
  241.    First off, you'll want libg++ as you can do almost nothing without
  242. it (unless you replace it with some other class library).
  243.  
  244.    Second, depending on your platform, you may need "gas", the GNU
  245. assembler, or the GNU linker (see next question).
  246.  
  247.    Finally, while it is not required, you'll almost certainly want the
  248. GNU debugger, gdb.  The latest version is 4.9, released May 12, 1993. 
  249. Other debuggers (like dbx, for example) will normally not be able to
  250. understand at least some of the debug information produced by g++.
  251.  
  252.  
  253. Should I use the GNU linker, or should I use "collect"?
  254. =======================================================
  255.  
  256.    First off, for novices: special measures must be taken with C++ to
  257. arrange for the calling of constructors for global or static objects
  258. before the execution of your program, and for the calling of
  259. destructors at the end.  (Exception: System VR3 and System VR4 linkers
  260. support user-defined segments; g++ on these systems requires neither
  261. the GNU linker nor collect.  So if you have such a system, the answer
  262. is that you don't need either one).
  263.  
  264.    If you have experience with AT&T's "cfront", this function is
  265. performed there by programs named "patch" or "munch".  With GNU C++,
  266. it is performed either by the GNU linker or by a program known as
  267. "collect".  The collect program is part of the gcc-2.x distribution;
  268. you can obtain the GNU linker separately as part of the "binutils"
  269. package.  The latest version of binutils is 2.2.1, released May 21,
  270. 1993.
  271.  
  272.    (To be technical, it's "collect2"; there were originally several
  273. alternative versions of collect, and this is the one that survived).
  274.  
  275.    There are advantages and disadvantages to either choice.
  276.  
  277.    Advantages of the GNU linker:
  278.  
  279.    It's faster than using collect -- collect basically runs the
  280. standard Unix linker on your program twice, inserting some extra code
  281. after the first pass to call the constructors.  This is a sizable time
  282. penalty for large programs.  The GNU linker does not require this
  283. extra pass.
  284.  
  285.    GNU ld reports undefined symbols using their true names, not the
  286. mangled names.
  287.  
  288.    If there are undefined symbols, GNU ld reports which object file(s)
  289. refer to the undefined symbol(s).
  290.  
  291.    As of binutils version 2.2, on systems that use the so-called
  292. "a.out" debug format (e.g. Suns running SunOS 4.x), the GNU linker
  293. compresses the debug symbol table considerably, which in at least some
  294. cases may make up, in disk space, for its inability to use shared
  295. libraries.
  296.  
  297.    Advantages of collect:
  298.  
  299.    If your native linker supports shared libraries, you can use shared
  300. libraries with collect.  The GNU linker does not (yet) support shared
  301. libraries.
  302.  
  303.    Note: using existing shared libraries (X and libc, for example)
  304. works very nicely; generating shared libraries from g++-compiled code
  305. is another matter, generally requiring OS-dependent tricks if it is
  306. possible at all.
  307.  
  308.    The GNU linker has not been ported to as many platforms as g++ has,
  309. so you may be forced to use collect.
  310.  
  311.    If you use collect, you don't need to get something extra and
  312. figure out how to install it; the standard gcc installation procedure
  313. will do it for you.
  314.  
  315.    In conclusion, I don't see a clear win for either alternative at
  316. this point.  Take your pick.
  317.  
  318.  
  319. Should I use the GNU assembler, or my vendor's assembler?
  320. =========================================================
  321.  
  322.    This depends on your platform and your decision about the GNU
  323. linker.  For most platforms, you'll need to use gas if you use the GNU
  324. linker.  For some platforms, you have no choice; check the gcc
  325. installation notes to see whether you must use gas.  But you can
  326. usually use the vendor's assembler if you don't use the GNU linker.
  327.  
  328.    The GNU assembler assembles faster than many native assemblers;
  329. however, on many platforms it cannot support the local debugging
  330. format.
  331.  
  332.  
  333. Should I use the GNU C library?
  334. ===============================
  335.  
  336.    At this point in time, no.  The GNU C library is still very young,
  337. and libg++ still conflicts with it in some places.  Use your native C
  338. library unless you know a lot about the gory details of libg++ and
  339. gnu-libc.  This will probably change in the future.
  340.  
  341.  
  342. Problems building libg++ on 386/486
  343. ===================================
  344.  
  345.    Attempts to install libg++ on 386 or 486 systems running ports of
  346. SVR4 have problems because of bugs in debugging support on that
  347. platform.  Briefly, debugging does not currently work right yet for
  348. C++.  You should be able to build the library successfully by deleting
  349. the -g flag from the Makefiles (this should no longer be necessary
  350. with gcc 2.4.1 although debugging still doesn't work).
  351.  
  352.    See the section entitled "Debugging on SVR4 systems."
  353.  
  354.  
  355. Other problems building libg++
  356. ==============================
  357.  
  358.    "I am having trouble building libg++-2.2 or 2.3.  Help!"
  359.  
  360.    On some platforms (for example, Ultrix), you may see errors
  361. complaining about being unable to open dummy.o.  On other platforms
  362. (for example, SunOS), you may see problems having to do with the type
  363. of size_t.  The fix for these problems is to make libg++ by saying
  364. "make CC=gcc".  According to Per Bothner, it should no longer be
  365. necessary to specify "CC=gcc" for libg++-2.3.1.
  366.  
  367.  
  368. Do I need to rebuild libg++ to go with my new g++?
  369. ==================================================
  370.  
  371.    "After I upgraded g++ to the latest version, I'm seeing undefined
  372. symbols."
  373.  
  374.    or
  375.  
  376.    "If I upgrade to a new version of g++, do I need to reinstall
  377. libg++?"
  378.  
  379.    This depends; as a rule, some upgrades will require rebuilding
  380. libg++ and others will not.  Both versions 2.3.3 and 2.4.0 introduced
  381. some incompatibilities with previous versions.  For 2.3.3, the name
  382. mangling of certain virtual table names changed, which introduced an
  383. incompatiblity.  For 2.4.0, the type of "size_t" changed on Suns from
  384. int (as declared by the include files provided by Sun) to unsigned
  385. long (the ANSI C and draft ANSI C++ standards declare that size_t must
  386. be unsigned, and the GCC maintainers are now correcting this "bug").
  387.  
  388.    Conclusion: if your old compiler is an older version than 2.3.3, you
  389. must rebuild libg++ when you install a new g++.  If your vendor
  390. declares size_t to be a signed type and your old compiler is an older
  391. version than 2.4.0, you also must rebuild libg++.
  392.  
  393.    This would be a good opportunity to upgrade to the libg++ 2.3.1
  394. release if you haven't yet, to minimize the amount of rebuilding.
  395.  
  396.  
  397. User Problems
  398. *************
  399.  
  400.  
  401. Linker reports undefined symbols for static data members
  402. ========================================================
  403.  
  404.    "g++ reports undefined symbols for all my static data members when
  405. I link, even though the program works correctly for compiler XYZ. 
  406. What's going on?"
  407.  
  408.    The problem is almost certainly that you don't give definitions for
  409. your static data members.  If you have
  410.  
  411.      class Foo {
  412.          ...
  413.          void method();
  414.          static int bar;
  415.      };
  416.  
  417.    you have only declared that there is an int named Foo::bar and a
  418. member function named Foo::method that is defined somewhere.  You
  419. still need to defined BOTH method() and bar in some source file. 
  420. According to the draft ANSI standard, you must supply an initializer,
  421. such as
  422.  
  423.      int Foo::bar = 0;
  424.  
  425. in one (and only one) source file.
  426.  
  427.  
  428. g++ won't accept the placement new syntax.
  429. ==========================================
  430.  
  431.    "I have a program that uses the "placement syntax" of operator new,
  432. e.g.
  433.  
  434.         new (somewhere) T;
  435.  
  436. and g++ won't accept it."
  437.  
  438.    Up until version 2.3.1, g++ accepted an alternate form of the
  439. placement syntax, for historical reasons; use
  440.  
  441.         new {somewhere} T;
  442.  
  443. if you are using g++-2.2.2 or older.
  444.  
  445.    As of 2.3.1, g++ finally fixed this, using the standard ARM syntax
  446. for "placement new".  A few remaining glitches were fixed in 2.3.2. 
  447. The only remaining problem is with declarators for pointers to
  448. functions;
  449.  
  450.      new (void (*)(int));  // confuses gcc 2.3.2
  451.      new (a) (void (*)(int)); // ditto
  452.  
  453.    These can be worked around with a typedef:
  454.  
  455.      typedef void (*fun)(int);
  456.      new fun;
  457.      new (a) fun;
  458.  
  459.  
  460. I think I have found a bug in g++.
  461. ==================================
  462.  
  463.    "I think I have found a bug in g++, but I'm not sure.  How do I
  464. know, and who should I tell?"
  465.  
  466.    First, see the excellent section on bugs and bug reports in the gcc
  467. manual (which is included in the gcc distribution).  As a short
  468. summary of that section: if the compiler gets a fatal signal, for any
  469. input, it's a bug (newer versions of g++ will ask you to send in a bug
  470. report when they detect an error in themselves).  Same thing for
  471. producing invalid assembly code.
  472.  
  473.    When you report a bug, make sure to describe your platform (the
  474. type of computer, and the version of the operating system it is
  475. running) and the version of the compiler that you are running.  Also
  476. provide enough code so that the g++ maintainers can duplicate your bug.
  477.  
  478.    I will add some extra notes that are C++-specific, since the notes
  479. from gcc are generally C-specific.
  480.  
  481.    First, mail your bug report to "bug-g++@prep.ai.mit.edu".  You may
  482. also post to gnu.g++.bug, but it's better to use mail, particularly if
  483. you have any doubt as to whether your news software generates correct
  484. reply addresses.  Don't mail C++ bugs to bug-gcc@prep.ai.mit.edu.
  485.  
  486.    If your bug involves libg++ rather than the compiler, mail to
  487. bug-libg++@prep.ai.mit.edu.  If you're not sure, you could send your
  488. bug to both lists.
  489.  
  490.    Second, if your program does one thing, and you think it should do
  491. something else, it is best to consult a good reference if in doubt. 
  492. The standard reference is "The Annotated C++ Reference Manual", by
  493. Ellis and Stroustrup (copyright 1990, ISBN #0-201-51459-1).  This is
  494. what they're talking about on the net when they refer to "the ARM".
  495.  
  496.    The reference manual, without annotations, also appears in
  497. Stroustrup's "The C++ Programming Language, Second Edition" (copyright
  498. 1991, ISBN #0-201-53992-6).  Both books are published by
  499. Addison-Wesley.
  500.  
  501.    Note that the behavior of (any version of) AT&T's "cfront" compiler
  502. is NOT the standard for the language.
  503.  
  504.  
  505. Porting programs from other compilers to g++
  506. ============================================
  507.  
  508.    "I have a program that runs on <some other C++ compiler>, and I want
  509. to get it running under g++.  Is there anything I should watch out
  510. for?"
  511.  
  512.    First, see the questions on placement new syntax and static data
  513. members.
  514.  
  515.    There are two other reasons why a program that worked under one
  516. compiler might fail under another: your program may depend on the
  517. order of evaluation of side effects in an expression, or it may depend
  518. on the lifetime of a temporary (you may be assuming that a temporary
  519. object "lives" longer than the standard guarantees).  As an example of
  520. the first:
  521.  
  522.      void func(int,int);
  523.      
  524.      int i = 3;
  525.      func(i++,i++);
  526.  
  527.    Novice programmers think that the increments will be evaluated in
  528. strict left-to-right order.  Neither C nor C++ guarantees this; the
  529. second increment might happen first, for example.  func might get 3,4,
  530. or it might get 4,3.
  531.  
  532.    The second problem often happens with classes like the libg++ String
  533. class.  Let's say I have
  534.  
  535.      String func1();
  536.      void func2(const char*);
  537.  
  538.    and I say
  539.  
  540.      func2(func1());
  541.  
  542.    because I know that class String has an "operator const char*".  So
  543. what really happens is
  544.  
  545.      func2(func1().convert());
  546.  
  547.    where I'm pretending I have a convert() method that is the same as
  548. the cast.  This is unsafe, because the temporary String object may be
  549. deleted after its last use (the call to the conversion function),
  550. leaving the pointer pointing to garbage, so by the time func2 is
  551. called, it gets an invalid argument.
  552.  
  553.    If you think this is ugly, you should know that the ANSI C++
  554. committee is still debating the lifetime-of-temporaries problem.
  555.  
  556.    For now, the safe way to write such code is to give the temporary a
  557. name, which forces it to live until the end of the scope of the name.
  558. For example:
  559.  
  560.      String& tmp = func1();
  561.      func2(tmp);
  562.  
  563.    Finally, like all compilers (but especially C++ compilers, it
  564. seems), g++ has bugs, and you may have tweaked one.
  565.  
  566.  
  567. Why does g++ mangle names differently from other C++ compilers?
  568. ===============================================================
  569.  
  570.    See the answer to the next question.
  571.  
  572.  
  573. Why can't g++ code link with code from other C++ compilers?
  574. ===========================================================
  575.  
  576.    "Why can't I link g++-compiled programs against libraries compiled
  577. by some other C++ compiler?"
  578.  
  579.    Some people think that, if only the FSF and Cygnus Support folks
  580. would stop being stubborn and mangle names the same way that, say,
  581. cfront does, then any g++-compiled program would link successfully
  582. against any cfront-compiled library and vice versa.  Name mangling is
  583. the least of the problems.  Compilers differ as to how objects are
  584. laid out, how multiple inheritance is implemented, how virtual
  585. function calls are handled, and so on, so if the name mangling were
  586. made the same, your programs would link against libraries provided
  587. from other compilers but then crash when run.  For this reason, the
  588. ARM *encourages* compiler writers to make their name mangling
  589. different from that of other compilers for the same platform. 
  590. Incompatible libraries are then detected at link time, rather than at
  591. run time.
  592.  
  593.  
  594. What documentation exists for g++ 2.x?
  595. ======================================
  596.  
  597.    Relatively little.  The gcc manual describes the C front end, and
  598. also the back end, which is shared by the C++ compiler, but there is
  599. relatively little documentation for the C++ front end beyond a cursory
  600. description of the command line options (although more C++ specific
  601. information has been added to the gcc manual as of version 2.4.1).
  602.  
  603.    There is a Unix-style manual entry, "g++.1", in the gcc-2.x
  604. distribution; this describes the extra command-line options that g++
  605. supports, and the #pragma interface and #pragma implementation
  606. directives.
  607.  
  608.    (Latest news: as of 2.4.0, these pragmas are finally described in
  609. the main gcc manual).
  610.  
  611.    A draft of a document describing the g++ internals appears in the
  612. gcc distribution (called g++int.texi); it is still incomplete.
  613.  
  614.  
  615. What are the differences between g++ and the ARM specification of C++?
  616. ======================================================================
  617.  
  618.    The chief thing missing from g++ that is in the ARM is exceptions
  619. (the other major compilers do not have exceptions either).  There are
  620. bits and pieces of exception code present, but it is not presently
  621. usable.
  622.  
  623.    The template implementation is still new.  The implementation in
  624. 2.4.1 represents a considerable improvement over that of previous
  625. releases, but it has a long way to go.
  626.  
  627.    g++ does not implement a separate pass to instantiate template
  628. functions and classes at this point; for this reason, it will not
  629. work, for the most part, to declare your template functions in one
  630. file and define them in another.  The compiler will need to see the
  631. entire definition of the function, and will generate a static copy of
  632. the function in each file in which it is used.
  633.  
  634.    As with any beta-test compiler, there are bugs.  You can help
  635. improve the compiler by submitting detailed bug reports.
  636.  
  637.    [A full bug list would be very long indeed, so I won't put one here. 
  638. I may add a list of frequently-reported bugs and "non-bugs" like the
  639. static class members issue mentioned above].
  640.  
  641.  
  642. Will g++ compile InterViews?  The NIH class library?
  643. ====================================================
  644.  
  645.    The NIH class library uses a non-portable, compiler-dependent hack
  646. to initialize itself, which makes life difficult for g++ users.  It
  647. will not work without modification, and I don't know what modifications
  648. are required or whether anyone has done them successfully.
  649.  
  650.    Brendan Kehoe of Cygnus Support is working on getting NIHCL to
  651. build with g++.  He says, "The NIHCL release will hopefully contain
  652. patches to gcc to let it build."
  653.  
  654.    [ From Steinar Bang <steinarb@idt.unit.no>]
  655.  
  656.    InterViews 3.1 compiles and runs with gcc-2.3.3 and libg++-2.3,
  657. except that the "doc" application immediately dumps core when you try
  658. to run it.  There is also a small glitch with idraw.
  659.  
  660.    There is a patch for InterViews 3.1 from Johan Garpendahl
  661. <garp@isy.liu.se> available for FTP from site "ugle.unit.no".  It is
  662. in the file
  663.  
  664.    /pub/X11/contrib/InterViews/g++/3.1-beta3-patch.
  665.  
  666.    This fixes two things: the Doc coredump, and the pattern menu of
  667. idraw.  Read the instructions at the start of the file.
  668.  
  669.    [ I don't know whether the situation has changed with 2.4.0 ]
  670.  
  671.  
  672. Debugging on SVR4 systems
  673. =========================
  674.  
  675.    "When I use the -g flag on C++ code on a System V Release 4 system,
  676. I get lots of undefined symbols at link time.  Why?  Help!"
  677.  
  678.    [From Ron Guilmette:] The changes needed to get the g++ front-end
  679. to generate proper DWARF style debugging information for System V
  680. Release 4 are not yet completed, nor will they be until g++ version
  681. 2.4 (at the earliest).
  682.  
  683.    (Guess what?  2.4 is out, and it *still* doesn't work, but now g++
  684. will give you a warning message and turn off debugging rather than put
  685. out bogus assembly code.  Latest word from Brendan Kehoe: "it should
  686. work [better] in whatever major release comes after 2.4.1 ...").
  687.  
  688.    [Ron again:] There is nothing that you (as an end-user) can do to
  689. correct this problem.  (It is actually *many* problems, and they are
  690. all very complex.)  Until the g++ maintainers have time to fix this,
  691. you should simply *avoid* using the -g option when using g++ on SVR4.
  692.  
  693.  
  694. What are the rules for shipping code built with g++ and libg++?
  695. ***************************************************************
  696.  
  697.    "Is it is possible to distribute programs for profit that are
  698. created with g++ and use the g++ libraries?"
  699.  
  700.    I am not a lawyer, and this is not legal advice.  In any case, I
  701. have little interest in telling people how to violate the spirit of the
  702. GNU licenses without violating the letter.  This section tells you how
  703. to comply with the intention of the GNU licenses as best I understand
  704. them.
  705.  
  706.    The FSF has no objection to your making money.  Its only interest
  707. is that source code to their programs, and libraries, and to modified
  708. versions of their programs and libraries, is always available.
  709.  
  710.    The short answer is that you do not need to release the source to
  711. your program, but you can't just ship a stripped executable either.
  712.  
  713.    Compiling your code with a GNU compiler does not affect its
  714. copyright; it is still yours.  However, in order to ship code that
  715. links in a GNU library such as libg++ there are certain rules you must
  716. follow.  The rules are described in the file COPYING.LIB that
  717. accompanies gcc distributions; it is also included in the libg++
  718. distribution.  See that file for the exact rules.  The agreement is
  719. called the Library GNU Public License or LGPL.  It is much "looser"
  720. than the GNU Public License, or GPL, that covers must GNU programs.
  721.  
  722.    Here's the deal: let's say that you use some version of libg++,
  723. completely unchanged, in your software, and you want to ship only a
  724. binary form of your code.  You can do this, but there are several
  725. special requirements.  If you want to use libg++ but ship only object
  726. code for your code, you have to ship source for libg++ (or ensure
  727. somehow that your customer already has the source for the exact
  728. version you are using), and ship your application in linkable form. 
  729. You cannot forbid your customer from reverse-engineering or extending
  730. your program by exploiting its linkable form.
  731.  
  732.    Furthermore, if you modify libg++ itself, you must provide source
  733. for your modifications (making a derived class does not count as
  734. modifying the library -- that is "a work that uses the library").
  735.  
  736.  
  737. Concept Index
  738. *************
  739.  
  740. --
  741. Joe Buck    jbuck@ohm.EECS.Berkeley.EDU
  742.